<!DOCTYPE html>
<html lang="en">
<head>
	<meta charset="UTF-8">
	<meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
	<title>返回空 Buckets | Elasticsearch: 权威指南 | Elastic</title>
    <!-- Give IE8 a fighting chance -->
    <!--[if lt IE 9]>
    <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
    <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
    <![endif]-->
	<link rel="stylesheet" type="text/css" href="../static/styles.css" />
</head>
<body>
<div class="main-container">
    <section id="content">
        
        <div class="content-wrapper">
            <section id="guide" lang="zh_cn">
                <div class="container">
                    <div class="row">
                        <div class="col-xs-12 col-sm-8 col-md-8 guide-section">
                            <div style="color:gray; word-break: break-all; font-size:12px;">原文地址: <a href="https://www.elastic.co/guide/cn/elasticsearch/guide/current/_returning_empty_buckets.html" rel="nofollow">https://www.elastic.co/guide/cn/elasticsearch/guide/current/_returning_empty_buckets.html</a>, 版权归 www.elastic.co 所有<br/>
                            英文版地址: <a href="https://www.elastic.co/guide/en/elasticsearch/guide/current/_returning_empty_buckets.html" rel="nofollow">https://www.elastic.co/guide/en/elasticsearch/guide/current/_returning_empty_buckets.html</a>
                            </div>
                        <!-- start body -->
                  <div class="page_header">
<b>请注意:</b><br>本书基于 Elasticsearch 2.x 版本，有些内容可能已经过时。
</div>
<div id="content">
<div class="breadcrumbs">
<span class="breadcrumb-link"><a href="index.html">Elasticsearch: 权威指南</a></span>
»
<span class="breadcrumb-link"><a href="aggregations.html">聚合</a></span>
»
<span class="breadcrumb-link"><a href="_looking_at_time.html">按时间统计</a></span>
»
<span class="breadcrumb-node">返回空 Buckets</span>
</div>
<div class="navheader">
<span class="prev">
<a href="_looking_at_time.html">« 按时间统计</a>
</span>
<span class="next">
<a href="_extended_example.html">扩展例子 »</a>
</span>
</div>
<div class="section">
<div class="titlepage"><div><div>
<h2 class="title">
<a id="_returning_empty_buckets"></a>返回空 Buckets<a class="edit_me edit_me_private" rel="nofollow" title="Editing on GitHub is available to Elastic" href="https://github.com/elasticsearch-cn/elasticsearch-definitive-guide/edit/cn/300_Aggregations/35_date_histogram.asciidoc">edit</a>
</h2>
</div></div></div>
<p>注意到结果末尾处的奇怪之处了吗？</p>
<p>是的，结果没错。 但是我们的结果少了一些月份！ <code class="literal">date_histogram</code> （和 <code class="literal">histogram</code> 一样）默认只会返回文档数目非零的 buckets。</p>
<p>这意味着你的 histogram 总是返回最少的结果。通常，你并不想要这样。对于很多应用，你可能想直接把结果导入到图形库中，而不想做任何后期加工。</p>
<p>事实上，即使 buckets 中没有文档我们也想返回。可以通过设置两个额外的参数 (<code class="literal">min_doc_count</code>, <code class="literal">extended_bounds</code>) 来实现这种效果：</p>
<div class="pre_wrapper lang-sense">
<pre class="programlisting prettyprint lang-sense">GET /cars/transactions/_search
{
   "size" : 0,
   "aggs": {
      "sales": {
         "date_histogram": {
            "field": "sold",
            "interval": "month",
            "format": "yyyy-MM-dd",
            "min_doc_count" : 0, <a id="CO194-1"></a><i class="conum" data-value="1"></i>
            "extended_bounds" : { <a id="CO194-2"></a><i class="conum" data-value="2"></i>
                "min" : "2014-01-01",
                "max" : "2014-12-31"
            }
         }
      }
   }
}</pre>
</div>
<div class="sense_widget" data-snippet="snippets/300_Aggregations/35_date_histogram.json"></div>
<div class="calloutlist">
<table border="0" summary="Callout list">
<tr>
<td align="left" valign="top" width="5%">
<p><a href="#CO194-1"><i class="conum" data-value="1"></i></a></p>
</td>
<td align="left" valign="top">
<p>参数<code class="literal">min_doc_count</code>强制返回空 buckets。</p>
</td>
</tr>
<tr>
<td align="left" valign="top" width="5%">
<p><a href="#CO194-2"><i class="conum" data-value="2"></i></a></p>
</td>
<td align="left" valign="top">
<p>参数<code class="literal">extended_bounds</code>强制返回整年(参数max和min之间的12个月)。</p>
</td>
</tr>
</table>
</div>
<p>这两个参数会强制返回一年中所有月份的结果，而不考虑结果中的文档数目。 <code class="literal">min_doc_count</code> 非常容易理解：它强制返回所有 buckets，即使是文档数量为零的空bucket。</p>
<p><code class="literal">extended_bounds</code> 参数需要一点解释。  <code class="literal">min_doc_count</code> 参数强制返回空 buckets，但是 Elasticsearch 默认只返回你的数据中最小值和最大值之间的 buckets。</p>
<p>因此如果你的数据只落在了 4 月和 7 月之间，那么你只能得到这些月份的 buckets（可能为空也可能不为空）。因此为了得到全年数据，我们需要告诉 Elasticsearch 我们想要全部 buckets，
即便那些 buckets 可能落在最小日期 <em>之前</em> 或 最大日期 <em>之后</em> 。</p>
<p><code class="literal">extended_bounds</code> 参数正是如此。一旦你加上了这两个设置，你可以把得到的结果轻易地直接插入到你的图形库中，从而得到类似 <a class="xref" href="_returning_empty_buckets.html#date-histo-ts1" title="汽车销售时间图">Figure 37, “汽车销售时间图”</a> 的图表。</p>
<div id="date-histo-ts1" class="imageblock">
<div class="content">
<img src="../images/elas_29in01.png" alt="汽车销售时间图">
</div>
<div class="title">Figure 37. 汽车销售时间图</div>
</div>
</div>
<div class="navfooter">
<span class="prev">
<a href="_looking_at_time.html">« 按时间统计</a>
</span>
<span class="next">
<a href="_extended_example.html">扩展例子 »</a>
</span>
</div>
</div>

                  <!-- end body -->
                        </div>
                        <div class="col-xs-12 col-sm-4 col-md-4" id="right_col">
                        
                        </div>
                    </div>
                </div>
            </section>
        </div>
    </section>
</div>
<script src="../static/cn.js"></script>
</body>
</html>